This manual contains some hints on how to install DirectTeX and how to do the first steps with DirectTeX. You will find more information in the manuals supplied with DirectTeX. Because TeX is a wonderfull publishing system, the manual has been composed with TeX and may be viewed or printed using DirectTeX, so the first thing you will learn is how to print the manual and registration card after successfull installation.
1. Introduction
TeX is a professional typesetting system developed by Donald E. Knuth since 1982. The main purpose of TeX is the typesetting of high-quality documents, especially with mathematical formulae included. A lot of books, e.g. about Mathematics or Computer Science, have been typeset using TeX. Even notes, papers, books without any formula may benefit from TeX's strong capabilities, like automatic generation of a table of contents, an index, a bibliography, easy reformatting, ...
METAFONT is a program to create fonts for TeX. Like TeX itself, METAFONT is a compiler that reads some textual input that follows a given syntax and produces some files that can be used by other programs. METAFONT creates the fonts that are needed to preview or print the documents typeset by TeX using a program like MacDVI.
There are a lot of utility programs that are usefull when typesetting documents with TeX and creating fonts with METAFONT.
DirectTeX is a implementation of TeX for the Apple Macintosh. DirectTeX has been designed as single tools that either run under the DirectTeX Pro shell or the MPW (Macintosh Programmers WorkShop) Shell, a Unix-like shell developed by Apple Computer, Inc. The DirectTeX Pro shell is included in the DirectTeX software package. MPW is commercial software sold by Apple, so before you can use DirectTeX under the MPW shell you have to buy MPW. Please contact your local Apple dealer for more information about MPW.
2. ShareWare and Copyright Notices
The DirectTeX program package by Wilfried Ricken is ShareWare. That means:
• Professional distribution of this software is strictly prohibited. This applies in particular to commercial public domain and shareware distributors.
• Once you received a copy of this program package, please pass it on to other people, e.g. your friends. Notice, however, that you are not allowed to ask for money apart from eventual costs of the diskettes.
• You are allowed to test this package. If after an appropriate amount of time you should find that you don't like it, then do delete it from your collection. Roughly 10 days of real work should be enough; of course, years are definitely too much :-).
• If you consider this software to be of use to you: Register as a DirectTeX user with me. Pay the ShareWare fee by mailing a cheque to me made payable to:
Wilfried Ricken
Hagenaustraße 41
45138 Essen
Germany
I can also send you details about my bank account if you prefer this option.
The ShareWare fees are:
• The ShareWare fee presently amounts to US-$ 100.-- or 150.-- DM for up to three installations. This fee covers all future versions of DirectTeX and allows you to use either the DirectTeX Pro shell or the MPW shell version. Each additional installation costs US-$ 20.-- or 30.-- DM.
Upon registration, you will receive a license and a serial number. Moreover, registered users of DirectTeX have the following advantages:
• You will immediately be notified of a new version. Updates may be received via the normal distribution channels without additional fees.
• Should you encounter a problem during installation or use of this software (but not regarding TeX, LaTeX or similar software), feel free to contact me. This holds also in case you discover bugs in my software or wish to propose improvements. Please contact me only by E-Mail or ordinary Mail. Do NOT phone me !
• A short remark: Unregistered users of DirectTeX may send me bug reports or other comments about DirectTeX, but do not expect any answer from me.
• One more remark: Please do support this software package even in case you never payed ShareWare fees up to now. Its development took a lot of work and time. I hope there will be people who understand and act appropriately.
Furthermore: Just compare all the features of this TeX and MetaFont package to others that are available for the Apple Macintosh. You will find that there is none as complete as the present one, neither public domain nor commercial. Also compare the costs of a commercial package to the ShareWare fee I ask for, taking into account the possibilities offered to influence further development of the present package.
3. Installation Instructions
The installation of DirectTeX is quite easy. DirectTeX is distributed on standard Macintosh HD disks (1.4MB capacity). You will need a Macintosh equipped with a appropriate disk drive.
If you would like to use DirectTeX under MPW: Please refer to the manuals that came with MPW on how to install MPW on your hard disk. It is not necessary to install DirectTeX and MPW on the same hard disk.
If you are an user of a previous release of DirectTeX, please make sure to delete all old files before installing this version of DirectTeX. Please delete the folder “DirectTeX” and the following files: “UserStartup•DirectTeX” or “UserStartup•TeX” within the MPW folder and “DirectTeX Preferences” within the preferences folder inside your system folder. Before deleting the folder “DirectTeX” you should move all files that did not come with the old DirectTeX installation to a save place (don't forget the pk files !!!). You may also think about renaming the old folder “DirectTeX” into “DirectTeX-Old” or something like that.
Now the installation may begin: Please look on the disk DirectTeX.1 and start the program “Installer” by double-clicking on it. After a copyright notice the main screen of the installation program will appear.
Use the button “Switch Disk” until the name of the disk on which you like to install DirectTeX appears. Note that you cannot install DirectTeX on a floppy disk or a hard disk with not enough space.
Now click “Install” if you want to do the simple installation (the program “Installer” will automatically install everything) or click “Customize” to select the software packages you would like to install.
After successfull installation, you should have got a folder called “DirectTeX” that looks something like the following:
The file “UserStartup•DirectTeX” is needed if you want to use DirectTeX under the MPW shell. In this case please drag this file into the MPW folder. Note that you may either delete the folder “Tools-MPW” if you want to use only the DirectTeX Pro shell or “Tools-Pro” if you want to use only the MPW shell because they contain only files needed by the specific shell.
Now you should start either the DirectTeX Pro or the MPW shell. After a warning about some undefined environment variables, a dialog like the following will appear:
Select the folder “DirectTeX” in the list and click “Select DirectTeX”. A second dialog will appear to select the local TeX folder. If you are using DirectTeX on a single computer, simply select the same folder “DirectTeX” and click “Select DirectTeX” again. The system will verify your selection, and now everything is up and running.
If you would like to use DirectTeX in a network environment, you may install the biggest part of DirectTeX on a file server, and only a small part on the local machine on which you would like to use DirectTeX. This installations may be done via “Customize” (see above...). In such a case you have to select to different folders: First you have to select the “DirectTeX” folder located on your file server, and second you have to select the “DirectTeX” folder on your local machine.
Now the DirectTeX registration dialog will appear:
If you already have some registration numbers, fill in the fields and click “Register”. If you do not have a license and serial number (which is probably true when using DirectTeX the first time because you have to print the registration form using DirectTeX) you may still use DirectTeX for testing. In this case please click “Not Yet”.
4. Printing the Manual and Registration Card
To create a registration card, simply select the menu item “Register ShareWare…” either from the Apple menu (DirectTeX Pro) or the “TeX” menu (MPW). DirectTeX will automatically call TeX, and after some time it will present you some questions about you, your computer system and the number of installations you would like to register. Please follow the instructions on the screen. After answering these questions a complete registration card has been created and will be viewed on your screen. You may print this registration card and send in the printed result, or you may convert the file “Registration.dvi” into a BinHex4 file and send this file per e-mail to me.
Printing the manual is quite easy. Make sure that you have selected the correct printer. In case of doubt use the “Chooser” located in the Apple Menu to do that. Now select “DirectTeX Manual” from the help menu. The manual file will be displayed. Select “Check For Fonts->Printer” from the “Options” menu. This command will check the manual for all needed fonts and generate the commands necessary to create missing fonts. Under the DirectTeX Pro shell, missing fonts will be generated online (if you didn't switch off this feature using the Preferences dialog). Under the MPW Shell, this is not possible. In this case you must close the window displaying the manual and select “Make Missing Fonts” from the “TeX” menu to generate the missing fonts. After that open the manual again. Select “Page Setup…” from the “File” menu to setup the proper page layout. Please note that some printer drivers have options that affect the printing of bitmaps. In such a case make sure that you DESELECT all that options because some fonts are simple bitmap-fonts that should not be modified by the printer driver. After that select “Print” from the “File” menu to print the manual.
For further information about DirectTeX please read carefully the manual !
Now everything should be ready for using DirectTeX. Refer to the file Manual.dvi for more information about DirectTeX. And now: Have fun !!!
Wilfried Ricken :-)
5. Troubleshooting
Under certain circumstances it might be that you get no output from MacDVI. Instead you will see a message like
Device description for “Fancy Printer” not found.
Using a new device description with mode_def := “Standard”.
or
Device description for “Fancy Printer” not found.
No mode_def with a resolution of 227 x 117 dpi found.
In such a case you are using a printer that is not supported by the standard DirectTeX installation. However, it is easy for you to include your printer into the list of supported printers:
• Find out the resolution of your printer, something like 227x117 dpi.
• Find out wether the printer supports PostScript or not.
• Type the following:
Edit $dt_DeviceDefs <RETURN> (DirectTeX Pro Shell)
Open "{dt_DeviceDefs}" <ENTER> (MPW Shell)
Insert something like
device_def 'Fancy Printer' = # My fancy printer... this is a comment !!!
device_type := PostScript;
mode_def := FancyMode;
enddef;
into the file. Note that you must specify QuickDraw instead of PostScript if your printer does not support PostScript. Note that METAFONT needs a mode_def for your printer. The mode_defs that are supplied with the standard installation of DirectTeX are listed at the beginning of the file "{DeviceDefs}". Try to find the mode_def with the resolution of your printer in this list. If there is no mode_def that matches your printer resolution then add a line like
FancyMode := (227, 117);
to the lines containing the mode_defs. However, you must define this mode_def in one of the METAFONT input files, but this may be done later. Now try to preview the manual and registration card again. This should work, only some complaints about missing fonts may appear again. If you added a new mode_def METAFONT will not be able to generate fonts because the mode_def is unknown to METAFONT. However, most of the fonts in the manual are ordinary Macintosh fonts, so you may print the manual even if some fonts are missing. Read the manual to learn something about mode_def's for METAFONT.